package com.heima.pojo.dto;

import lombok.Data;

/**
 * 用户分页查询DTO（接收前端分页+条件查询参数）
 */
@Data
public class UserQueryDTO {

    /**
     * 页码（非必须，默认值1，最小值1）
     * 说明：前端未传时默认查询第1页，避免页码小于1导致的查询异常
     */
    private Integer pageIndex = 1; // 默认值：第1页

    /**
     * 页大小（非必须，默认值10，取值范围1~100）
     * 说明：限制最大页大小为100，避免一次性查询过多数据导致性能问题
     */
    private Integer pageSize = 10; // 默认值：每页10条

    /**
     * 人员名称（非必须，支持模糊查询）
     * 说明：前端传空或null时，不按用户名筛选；传值时可匹配包含该名称的用户（如"张"匹配"张飞"、"张辽"）
     */
    private String userName; // 无默认值，null表示不筛选
    
    /**
     * 分页偏移量
     * 说明：用于数据库分页查询的offset值，由服务层计算得出
     */
    private Integer offset;
}